Skip to content

drums mcp: two-layer MCP stdio server, drums CLI, Claude Code plugin - #3

Merged
sahiljagtap08 merged 9 commits into
mainfrom
mcp-server
Nov 12, 2026
Merged

sahiljagtap08 merged 9 commits into
mainfrom
mcp-server

Conversation

@sahiljagtap08

@sahiljagtap08 sahiljagtap08 commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

SDK 0.3.0: the local drums mcp server, the drums CLI and a Claude Code plugin.

  • drums/mcp.py: a two-layer MCP stdio server over drums/mcp_tools.json (34 tools, byte-identical to the gateway's services/gateway/src/mcp/tools.json in Drums-Labs/drums). Workspace tools (computers, create, fork, runs, api_keys, audit) and per-desktop tools (screenshot, click, type, key, scroll, exec, read_file, write_file, gui, verify, reset, destroy).
  • drums console script: drums mcp [--env ID] [--url URL] [--create] [--print-config claude|claude-local|cursor|codex] and drums version. --print-config prints a drums_sk_... placeholder, never the token.
  • Client.runs / create_run / run / api_keys / create_api_key / revoke_api_key / audit for the gateway's /v1/runs, /v1/api-keys and /v1/audit routes.
  • Claude Code plugin at the repo root: .claude-plugin/plugin.json, .mcp.json, skills/drums-workflow/SKILL.md (create, act, verify, fork or reset, results; with the safety rules).
  • write_file chunks at 8000 base64 characters (the gateway caps each step argument at 8192); gui code is capped at 16384 characters, the gateway's pyautogui limit.
  • README: install, the server, client snippets, the tool list. CHANGELOG entry. Version 0.3.0; the wheel carries mcp_tools.json and the drums script. Dependencies stay empty (standard library only).

Tests: python3 -m unittest discover -s tests passes (53 tests). CI green on 3.9, 3.12, 3.13 at 928a0d8.

Status: merged as 4cd3850 on 2026-11-12 and reverted the same hour (ee24be6) pending an independent compatibility and security review; re-landing is gated on that review. 0.3.0 is not published to PyPI.

…ey, audit (gateway v1 routes); call() takes extra headers; 0.3.0
…pace + desktop tools), schema validation, confirm refusals before any request, --env binding, gateway-only tools report not available on plain drumsd; tests against a fake gateway
…sor, codex) and version; console script and mcp_tools.json in the wheel
…ill (create, act, verify, fork, reset, read results; safety rules)
@sahiljagtap08
sahiljagtap08 changed the base branch from sota/t6 to main November 12, 2026 08:38
@sahiljagtap08

Copy link
Copy Markdown
Contributor Author

Rebased onto main (after the pypi-release merge, #5) on 2026-11-12 and retargeted from sota/t6 to main; 8 commits, version 0.3.0, distribution name drums-sdk kept. Conflicts resolved in pyproject.toml (main's PyPI metadata plus the drums console script and mcp_tools.json package data), README.md (main's five-minute start plus the MCP server section) and the CHANGELOG now carries a 0.3.0 entry.

Checks on the rebased branch: unittest 53 OK (Python 3.12); wheel builds as drums_sdk-0.3.0 with drums/mcp_tools.json and the drums entry point; drums/mcp_tools.json is byte-identical to the gateway's tools.json (sha256 dcb7a447).

Stays a draft on purpose: the 0.2.5 PyPI release goes out first; this ships as 0.3.0 after it. The hosted endpoint (https://beta.drums.run/gw/mcp) is live since Drums-Labs/drums#14.

…he real one (office_convert on a machine without soffice, as in CI)
@sahiljagtap08

Copy link
Copy Markdown
Contributor Author

CI on the rebased branch failed on all three Python versions in test_mcp_server.FakeDesktopTests (office_convert): the runners have no soffice and the test's FakeEnv raised FileNotFoundError where the real desktop returns exit 127. Fixed in 928a0d8 (the fake answers a missing binary with returncode 127 and "command not found"); verified locally with soffice hidden from PATH. CI is green now (3.9, 3.12, 3.13 pass; 3.12 also builds and twine-checks the wheel). Still a draft until 0.2.5 is out.

@sahiljagtap08
sahiljagtap08 marked this pull request as ready for review November 12, 2026 19:19
@sahiljagtap08
sahiljagtap08 merged commit 4cd3850 into main Nov 12, 2026
3 checks passed
sahiljagtap08 added a commit that referenced this pull request Nov 12, 2026
This reverts commit 4cd3850, reversing
changes made to d536841.
sahiljagtap08 added a commit that referenced this pull request Nov 12, 2026
SDK 0.3.0: drums mcp server and CLI, HTTPS-only token transport, same-origin-only redirects. Re-land of #3. Not published to PyPI; no tag.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant